home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / bbs / filelister146.lha / TACFl158.lha / TACFl.DOC < prev    next >
Text File  |  1995-01-28  |  7KB  |  166 lines
  1.  
  2.                       Transamiga CreateFileListe V1.58
  3.                       --------------------------------
  4.  
  5.               written 1994 by Mathias Supp
  6.                               2:2476/539.0@fidoclassic
  7.                               39:173/50.0@amiganet
  8.                               s_supp@ira.uka.de
  9.  
  10.               Sysop of the Amiga Inside I : ++49(0)721-854112 (ZyX192)
  11.                                             ++49(0)721-841292 (VFC288)
  12.                                             ++49(0)721-841230 (VFC288)
  13.  
  14.                           Release : 28.01.1995
  15.  
  16.  
  17. ============================================================================
  18.  
  19. Copyright :
  20. -----------
  21.  
  22. This program can be copied freely for privat use ONLY.
  23.  
  24. It's absolutely prohibited to get money in any form for this utility.
  25.  
  26. Exceptions need my expressly permission.
  27.  
  28. Exceptions : AmiNet-CD
  29.              Fred Fish Collection
  30.  
  31. ============================================================================
  32.  
  33. Introduction :
  34. --------------
  35.  
  36. This program was created because of some missing features in Sami's
  37. Filelister (hello Sami, where's SFL3 ? ;-) )
  38.  
  39. There were no errors by testing TACFl with enforcer and mungwall.
  40.  
  41. In this version TACfl needs at least 2888 Bytes of stack.
  42.  
  43. ============================================================================
  44.  
  45. Contents of Archive :
  46. ---------------------
  47.  - TACFl            : the program
  48.  - TACFl_NC         : the program without stack/overflow/...-checking
  49.                       maybe a bit faster :-)
  50.  - TACFl.DOC        : english documentation
  51.  - TACFl.DOK        : german documentation
  52.  
  53. ============================================================================
  54.  
  55. What does it do ?
  56. -----------------
  57.  
  58. Simply creates Filelists :-)
  59.  
  60. 1. complete Filelist
  61. 2. Filelist of certain areas
  62. 3. Newfileslisting
  63. 4. Indexfiles (optionally sorted)
  64.  
  65. Areas with no files won't be listed.
  66.  
  67. ============================================================================
  68.  
  69. Parameter :
  70. -----------
  71.  
  72. LISTFILE     : path and name of the filelist you want to create
  73. CONFIGPATH   : path to your TA-configs
  74.                default : bbs:configs/
  75. DAYS         : list files which are given days old (0=file from today !)
  76.                default : list all files
  77. SINCE        : list files since given date (TA-format !!!)
  78.                default : list all files
  79. AREAFLAGS    : list areas with the given flags
  80.                default : list all areas
  81. AREARANGE    : list areas in the given arearange
  82.                format : a-b (list from area a to b)
  83.                         a-  (list from area a to the last)
  84.                         -b  (list from the first area to b)
  85.                         a   (list area a)
  86.                all formats can be used at the same time by using the ","
  87.                for example : AREARANGE=1-5,7,20-,10-13
  88.                default : list all areas
  89. ADDCR        : adds a carriage return to each line for PC lamers ;-)
  90.                default : no carriage return
  91. HEADERFILE   : file to be at the beginning of the listing
  92.                default : no headerfile
  93. BOTTOMFILE   : file to be at the end of the listing
  94.                default : no bottomfile
  95. AREASTAT     : create a statistic after each area
  96.                default : no statistic
  97. COMPLETESTAT : create a complete statistic of all areas
  98.                default : no statistic
  99. CREATEINDEX  : create an UNSORTED(!!) index for TAFreq by Thomas Boerkel
  100.                and/or Filelister by Mathias Supp for VERY HIGH searching
  101.                perfomance; sort the indexfile for use with one of the
  102.                above utilities (e.g. SORT index index.sort)
  103.                default : create NORMAL filelist
  104. SORTINDEX    : create a sorted index for TAFreq/Filelister
  105.                default : do not sort
  106. DELEMPTY     : deletes the recent created filelist if ther're no files
  107. IGNOREENV    : ignore the ENV-variable created by Filelister ?
  108.                default : do not ignore
  109.  
  110. ============================================================================
  111.  
  112. History :
  113. ---------
  114.  
  115. V1.0   05.05.94 : - first Release, which was to slow in creating a complete
  116.                     filelist
  117.                   - makes enforcer hits
  118. V1.1   09.05.94 : - faster in all operations
  119.                   - all enforcer hits removed
  120. V1.2   25.05.94 : - up to 3 times faster while creating a complete filelist
  121. V1.3   05.06.94 : - creates an unsorted index for TAFreq and Filelister
  122. V1.4   07.06.94 : - optionally create sorted and/or shorted indexes
  123.        08.06.94 : - index will be sorted at the end with quicksort
  124.                     => VERY HIGH speed improvement
  125. V1.41  10.06.94 : - optimized string comparing => half sorting time
  126. V1.42  13.06.94 : - optimized reading of Files.BBS => little faster
  127. V1.5   15.06.94 : - uses data of Filelister v0.42+ when finding his
  128.                     ENV-variable => no reading from disk necessary
  129.                   - "SHORTINDEX"-option removed because there was no
  130.                     use for the long index
  131. V1.52  25.06.94 : - TACFl now doesn't change any more the original variables
  132.                     of Filelister (thanks to Martin for reporting a con-
  133.                     fusing reaction of Filelister)
  134.                   - changed the usage of the file.cfg corresponding to
  135.                     Filelister V0.431+
  136. V1.53  06.07.94 : - because Thomas flamed me to death ( ;-) ) I changed
  137.                     the creating of the filelist when sharing memory with
  138.                     filelister : there will no more be useless spaces at
  139.                     the end of the lines
  140. V1.54  13.07.94 : - fixed a bug that causes a crash of Filelister
  141. V1.55  29.07.94 : - fixed a bug that causes a "freemem error", thanks to
  142.                     Chris for reporting
  143. V1.56  07.08.94 : - double counting of files and bytes when using "days" or
  144.                     "since" fixed
  145. V1.57  08.11.94 : - some lines of the files.bbs in the aminet-cd vol. 4
  146.                     are longer than 100 characters. In this case TACfl
  147.                     crashed sometimes. Thanks to Harald for explicit
  148.                     reporting.
  149. V1.58  28.01.95 : - added parameter "DELEMPTY" (see above)
  150.  
  151. ============================================================================
  152.  
  153. Thanks to :
  154. -----------
  155. Thomas Boerkel for the idea of binary-searching
  156. Martin Eitel   for bug-reporting
  157. Chris Qonoey   for bug-reporting
  158. Sami Radwan    for developing/supporting/... Transamiga
  159. Harald Meinzer for bug-reporting
  160.  
  161. have fun
  162.  
  163. Mathias
  164.  
  165. P.S.:   Sorry for my bad english, but I hope you understood what I mean.
  166.